NOVELL TECHNICAL INFORMATION DOCUMENT TITLE: Cubix NetWare Connect Driver DOCUMENT ID: TID250165 DOCUMENT REVISION: A DATE: 06JUN94 ALERT STATUS: Yellow INFORMATION TYPE: Symptom Solution README FOR: AIOCUB.EXE NOVELL PRODUCT and VERSION: NetWare Connect 1.0 ABSTRACT: This file contains an AIO driver for the Cubix MP2008 Multiport Communications Board (certified for NetWare Connect). 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION. 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 SYMPTOM Problems occur when using the Cubix MT2008 multi-port communications board with NetWare Connect. SOLUTION Apply AIOCUBIX.NLM. Self-Extracting File Name: AIOCUB.EXE Files Included Size Date AIOCUBIX.NLM 17280 12-10-93 AIOCUB.TXT ( This File ) Installation Instructions: NOTE: This driver is supplied by Cubix. If you have questions about it, please contact Cubix. Copy AIOCUBIX.NLM to SYSTEM:SYS directory. ======================================= Hardware Configuration The MP2008 has a single switch bank labelled SW1 on the top edge of the adapter, near the end bracket. This switch bank consists of eight switches, numbered one through 8. These switches should only be changed while the system in which the MP2008 is located is powered off. A switch is in the ON position when it is toward the board. DEFAULT is ALL ON or TOWARD THE BOARD _______________________________________ Base I/O Address Selection The switches in bank SW1 set the I/O port address and the logical board number to be used by the MP2008. Switches 1 and 2 control the I/O port address, while switches 4-8 control the logical board number. Switch 3 is always ON. The MP2008 requires a series of 16 I/O locations to allow communications between the software driver provided and the hardware. Switches 1 and 2 set the base I/O address to be used for this I/O address range. The MP2008 supports four different I/O address ranges (numbers given in hexadecimal): Base I/O Address Range Switch 1 Switch 2 default 200 200-20F ON ON 210 210-21F ON OFF 300 300-30F OFF ON 310 310-31F OFF OFF 1. Select any base I/O address that does not conflict with other system hardware. If a base I/O address other than the default is selected, this address must be specified using a command line option when the MP2008's AIO driver is loaded. See the Software Installation and Configuration section. 2. ALL MP2008 BOARDS IN YOUR SYSTEM MUST USE THE SAME BASE I/O ADDRESS. Furthermore, I/O addresses used by the MP2008 must not conflict the I/O addresses in use by any other system hardware. _______________________________________ Logical Board Number Selection 1. Each MP2008 board installed in a server must be assigned a unique board number among all MP2008 boards in that system. The logical board number is used (along with a port number) to identify individual ports when the software driver is loaded. If two MP2008 adapters attempt to utilize the same logical board number, driver failures will result. 2. Any board number from zero to fifteen may be selected for use by a board. Cubix recommends that boards be assigned numbers sequentially, beginning with board number zero. Switch bank SW1 switches 4-8 are used to set the board number for the hardware. The MP2008 software dynamically detects the board numbers that are selected, so there are no command line options for board number specification for the MP2008 driver. The switch settings for the logical board number are the following: Switch Settings Logical Board SW4 SW5 SW6 SW7 SW8 default 0 ON ON ON ON ON 1 ON ON ON ON OFF 2 ON ON ON OFF ON 3 ON ON ON OFF OFF 4 ON ON OFF ON ON 5 ON ON OFF ON OFF 6 ON ON OFF OFF ON 7 ON ON OFF OFF OFF 8 ON OFF ON ON ON 9 ON OFF ON ON OFF 10 ON OFF ON OFF ON 11 ON OFF ON OFF OFF 12 ON OFF OFF ON ON 13 ON OFF OFF ON OFF 14 ON OFF OFF OFF ON 15 ON OFF OFF OFF OFF _______________________________________ Board Installation 1. Before installation of the MP2008, be sure to turn the system off and disconnect it from the power source. Inserting the MP2008 into a live computer may damage the MP2008 hardware and may severely injure you. 2. The MP2008 must be installed in a 16 bit ISA or 32 bit EISA compatible slot. Be sure to observe the overall system power requirements for the hosts hardware configuration. 3. After installing the MP2008 in an available slot, be sure to use a screw to secure the edge connector of the MP2008 to the system chassis. Firm installation of the adapter board helps to ensure that loose connections do not cause system unreliability or damage to the hardware. 4. Next, connect the provided MP2008 communications cable to the MP2008 board. IT IS VERY IMPORTANT THAT THE HOLD DOWN SCREWS ON THE CONNECTOR BE FIRMLY ATTACHED TO THE MP2008 ADAPTER BOARD. Failure to observe this requirement often results in misalignment of the connector, and intermittent communications signals that can cause abnormal communications session loss (or inhibition of communications altogether). 5. Be sure to double check the installation and configuration of the MP2008 hardware before powering on the system or proceeding to software installation and configuration. ======================================= Software Installation and Configuration _______________________________________ How to install and configure the MP2008 software. The MP2008 Multiport Communications Adapter includes an AIO software driver that executes as a NetWare Loadable Module (NLM) in a Novell NetWare server. This NLM, "AIOCUBIX.NLM", is loaded like other NLMs, with the server software. The MP2008 driver checks for hardware base I/O address conflicts with other types of hardware in its host system. If a conflict is detected, a prompt will ask for another selection. Remember to set the hardware switch settings using switches 1 and 2 of switch bank SW1 to match the selected software options. _______________________________________ Loading the Software using the Default Hardware Configuration Using the default hardware configuration (all switches in the ON position), means that no command line options are necessary to load the AIO driver. To load the NLM in this configuration, issue the following command to your NetWare server: LOAD AIOCUBIX The driver name, version, and date are displayed. The AIO driver attempts to locate all MP2008 boards in the system using the default I/O address. As each board is located, a message is displayed that indicates the self test results and whether the board was successfully loaded. If all boards do not load successfully, check the I/O base address settings and refer to the Troubleshooting section of the card's documentation. If all boards pass the self test and are successfully loaded, the MP2008 driver loads and the MP2008 is ready for use. AIO requires that boards be numbered starting from zero and that all boards using an individual driver have contiguous numbers. Therefore, include a "node=" parameter on the command line. If it is not included, AIO will not find the board or the ports on that board. For example: LOAD AIOCUBIX NODE=0 This will set the board number for this invocation of the driver to zero. Succeeding load commands for the driver require "node=1", "node=2" ... _______________________________________ Using Non-default Base I/O Address Configurations If non-default settings for the I/O base address are selected (as described in section 2.1), they must be specified when you load the AIOCUBIX.NLM driver. Use the command: LOAD AIOCUBIX PORT= where is "200", "210", "300", or "310", corresponding to the settings for switches 1 and 2 of switch bank SW1. Alternatively, the may be omitted, including only the parameter "PORT=", the operator will be prompted with valid I/O addresses. I/O addresses already in use by other components in the system are not included in the valid options list. ALL MP2008 BOARDS IN THE SYSTEM MUST USE THE SAME BASE I/O ADDRESS. Furthermore, I/O addresses used by the MP2008 must not conflict the I/O addresses in use by any other hardware in the system. _______________________________________ Board Names The MP2008 board automatically sets a default board name of "MP2008." To override this name and specify a name, use the command line option "NAME=". For example, the following command line establishes MP2008 boards using the name "MY_NAME": LOAD AIOCUBIX NAME=MY_NAME Cubix recommends using the default board name for the MP2008. _______________________________________ Unloading the MP2008 Driver from Memory The MP2008 AIO driver may be unloaded from server memory using the following command: UNLOAD AIOCUBIX There are no options for the unload command. Be sure to close any active connections before unloading the MP2008 driver. _______________________________________ Command Line Help An on line description of command line options is available for the MP2008 AIO driver. To view this command usage information, use the following command: LOAD AIOCUBIX HELP Note that the driver is not loaded if command help is requested. The driver must be loaded as described in this chapter. _______________________________________ Verifying that the Driver has Loaded Successfully In addition to the messages printed on the system console, the MP2008 provides a rear panel indicator lamp, visible through the bracket, that may be used to confirm that the driver has loaded successfully. The lamp states are: OFF SOLID - indicates that the driver is not present, that is, it has not yet been loaded, or that it has been unloaded. ON/OFF FLASHING - indicates that the driver is present and operating normally. ON SOLID - indicates that the board failed self-test or that the software load was unsuccessful. If the lamp is in the solid-ON state, consult the troubleshooting section for assistance in identifying the problem. Patch History: This is the first driver posted in the NetWire Library for the Cubix MP2008 Multiport Communications Board. Solution Specifics: The Cubix MP2008 Multiport Communications Board is a PC-AT form factor, ISA bus, state-of-the-art combination of high speed controller and UARTs that offers system administrators fast and reliable shared serial resources for "port controlled" networks. Using multiple MP2008 boards in a NetWare Connect or Cubix Connect communications system allows the system administrator to manage a "port pool" of simultaneous dial-in and/or dial-out asynchronous connections. Up to sixteen MP2008 adapters may be placed in a single system, provided sufficient slots and power are available. The MP2008 requires a single 16-bit ISA slot for each adapter. Connect communicates with the MP2008 via a supplied software driver AIOCUBIX, that provides an AIO (Asynchronous Input/Output) interface to various applications. This driver is loaded in a Novell NetWare or RunTime NetWare server, and provides the software interface for access to the MP2008 ports. The heart of the MP2008 is the 20MHz 80C286 processor with optimized code to move data between Connect and the 16550 class UARTs quickly enough to keep the ports operating at their full 115Kbps rating. The 16C550 UARTs with 16 byte buffers ensure that there will be no overruns or missed characters at full rated speed. The MP2008 is provided with an octopus cable with a 78 pin connector on the MP2008 end and eight 6 foot long cables terminating in DB-25 male "D" connectors, wired as Data Terminal Equipment (DTE), for connection to external RS-232 compatible devices such as modems, multiplexers and mainframe terminal ports. _______________________________________ 1.1 Theory of Operation NetWare Connect operates as a enhanced subset of Novell's file server software. NetWare Connect consists of core elements of the file server software, the NetWare Core Protocol (NCP), supplied as "Runtime NetWare", to support non file server services in the form of NetWare Loadable Modules (NLMs), and the Connect NLMs. Connect NLMs provide security and form the virtual links between a NetWare service, such as Remote Node Service (RNS) and IPX, or NASI Connection Services (NCS) and the outside world via an Asynchronous Input/Output (AIO), module. The MP2008 and its associated NLM driver, AIOCUBIX, form the actual Input/Output hardware/software module that moves data to/from the network under control of the Connect software. The Connect software moves data to/from the MP2008 board(s) via the ISA bus as a two byte "programmed I/O" data transfer using a dual ported RAM data buffer and "mailbox" on the MP2008 located at a defined Connect I/O port address. This dual ported RAM has, for each of the 8 ports: 8KByte buffers for transmit and receive data and "mailbox" area for status and control information. The MP2008 80C286-20MHz CPU moves data and control/status information to/from the UARTs and the Connect host CPU through the dual ported buffer RAM. _______________________________________ Appendix A - Specifications Software: Software Interface: AIO (as an NLM), name=AIOCUBIX.NLM Unloadable: yes Bit rates: 50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600, 19200, 38400, 57600, 115200 (bits per second) Word lengths: 5, 6, 7, and 8 bits Stop bits: 1, 1.5, 2 (as appropriate for word length) Parity types: none, even, odd, mark, space Flow control types: none, hardware (RTS/CTS), software (Xon/Xoff), hardware and software Port deadman timers supported RS-232 break signal generated and detected Firmware: dynamically loaded from driver software Hardware: CPU: 80C286 (20 Mhz) UARTs:4 each, 16C552 (dual port) Receive buffer: 16 Byte FIFO Transmit buffer: 16 Byte FIFO Number of ports: eight total, asynchronous, RS-232 RS-232 connectors: 25-pin male D-connectors, via octopus cable RS-232 signals: TxD, RxD, RTS, CTS, DSR, Gnd, DCD, DTR, RI System bus: 16-bit ISA slot; full length, AT form factor System bus data rate: 4MBytes per second (32 Mbits per second) 8MHz bus, zero wait states Read buffers: eight, (8191 bytes), SRAM, hardware assisted wrap Write buffers: eight, (8191 bytes), SRAM, hardware assisted wrap Mailbox buffer: one (16k bytes) SRAM (read buffers, write buffers, mailbox: dual ported) Local program memory 16k bytes, zero wait states System interface: dual port memory, via pre-fetched and post written I/O mapped port access Supported I/O ranges 200-20F, 210-21F, 300-30F, 310-31F (one required) IRQs required: none Memory ranges required: none DMA lines required: none Power requirements: 2.0a +5 volts 0.2a +12 volts 0.2a -12 volts FCC certifications: Class A Temperature: 0 to 40 degrees Centigrade (operation) 0 to 70 degrees Centigrade (storage) Humidity: 10 to 95% (non-condensing) _______________________________________ Appendix B - Cable Specifications B.1 RS-232 Cable Pinouts The Cubix MP2008 includes an "octopus" shielded cable that converts the 78-pin high density connector on the adapter to eight DB-25 male RS-232 D-connectors. All ports are wired as the DTE interface. The pinouts for the RS-232 connections are standard: 1 - chassis ground 2 - transmit data (TxD) Transmit Data - output 3 - receive data (RxD) Receive Data - input 4 - Request To Send (RTS) Ready To Send - output 5 - Clear To Send (CTS) Clear To Send - input 6 - Data Set Ready (DSR) Data Set Ready - input 7 - signal ground (GND) Ground 8 - Data Carrier Detect (DCD) Data Carrier Detect - input 20 - Data Terminal Read (DTR) Data Terminal Ready - output 22 - Ring Indicator (RI) Ring Indicate - input Leads denoted as "output" are outputs from the MP2008. Conversely, leads denoted as "input" are inputs to the MP2008. All other pins are "No Connects" B.2 Connection to Modems Because modems are DCE devices and the MP2008 provides a DTE interface, a straight-through cable is sufficient to connect a modem to the MP2008. At a minimum, connections should be provided on the leads noted in section B.1 above. Connections on all 25 leads are acceptable. B.3 Connection to Hosts, Workstations, PCs, or Terminals Direct connection of the MP2008's RS-232 ports to hosts, workstations, PCs, or terminals configured as DTE equipment (without a intermediate modem or DCE device) generally requires a "null modem" cable. A "null modem" cable is so called, because it eliminates the need for modems (DCE devices) by crossing RS-232 signal pairs between the two DTE devices, such that each "sees" the other as a DCE device. To make a "null-modem" cable, use the following connections: MP2008 side other DTE side 2 --------------------- 3 3 --------------------- 2 4 --------------------- 5 5 --------------------- 4 7 --------------------- 7 6 -----|--------------- 20 8 -----| 20 ---------------|----- 6 |----- 8 ---------------------------------------------------------------- Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information. ---------------------------------------------------------------- �